The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
docs	Skipped		Apr 29, 2026 7:03pm

PR Summary

Medium Risk
Adds a new server route that downloads user files and proxies them to an external API, so regressions could impact uploads, auth enforcement, and error handling. Changes are otherwise additive and localized to the Firecrawl integration and docs.

Overview
Adds a new Firecrawl document parsing capability (firecrawl_parse) that accepts uploaded files or file references, forwards them via a new internal /api/tools/firecrawl/parse route to Firecrawl’s /v2/parse, and returns parsed markdown plus optional summary/HTML/metadata.

Updates the Firecrawl block/UI and tool registry to expose the new operation and its parse-specific options (formats, tag filters, parsers, timeout, ads/proxy/zero-retention), and updates docs/integration metadata accordingly. Also reverts the short-input selection styling tweak by removing selection:text-transparent.

^{Reviewed by Cursor Bugbot for commit 29580b3. Configure here.}

️✅ There are no secrets present in this pull request anymore.

If these secrets were true positive and are still valid, we highly recommend you to revoke them.
While these secrets were previously flagged, we no longer have a reference to the
specific commits where they were detected. Once a secret has been leaked into a git
repository, you should consider it compromised, even if it was deleted immediately.
Find here more information about risks.

^{_{🦉 GitGuardian detects secrets in your source code to help developers and security teams secure the modern development process. You are seeing this because you or someone else with access to this repository has authorized GitGuardian to scan your pull request.}}

Greptile Summary

This PR adds a firecrawl_parse operation to the Firecrawl block that accepts uploaded documents (PDF, DOCX, HTML, XLSX, etc.) and returns clean markdown via Firecrawl's /v2/parse API. It introduces a new internal proxy route at /api/tools/firecrawl/parse, a full tool definition in tools/firecrawl/parse.ts, supporting types, block UI sub-blocks (basic file-upload + advanced file-reference), and documentation — plus a one-line revert of a non-functional selection style on short-input.

Confidence Score: 5/5

Safe to merge — all findings are P2 style suggestions with no blocking defects.

The new parse operation follows all established patterns for file-handling, auth, error forwarding, tool registration, and response transformation. No P0 or P1 issues found. Two P2 items: an accidental one-line removal in notion.mdx and a proxy dropdown missing a none entry.

apps/docs/content/docs/en/tools/notion.mdx — verify the description removal is intentional.

Important Files Changed

Sequence Diagram

sequenceDiagram
    participant User as User / Workflow
    participant Block as FirecrawlBlock (parse case)
    participant Tool as firecrawl_parse tool
    participant Route as /api/tools/firecrawl/parse
    participant Storage as File Storage
    participant FC as Firecrawl API (/v2/parse)

    User->>Block: params.document (file-upload or file-reference)
    Block->>Block: normalizeFileInput(params.document)
    Block->>Tool: { file, formats, onlyMainContent, options... }
    Tool->>Route: POST JSON { apiKey, file, options }
    Route->>Route: checkInternalAuth
    Route->>Route: FirecrawlParseSchema.parse(body)
    Route->>Route: processFilesToUserFiles(file)
    Route->>Storage: downloadFileFromStorage(userFile)
    Storage-->>Route: buffer
    Route->>Route: new Blob(buffer) + FormData
    Route->>FC: POST multipart/form-data { file, options }
    FC-->>Route: { success, data: { markdown, ... } }
    Route-->>Tool: { success: true, output: data }
    Tool->>Tool: transformResponse → extract markdown, metadata, etc.
    Tool-->>User: { markdown, summary, html, links, metadata, warning }

_{Reviews (2): Last reviewed commit: "fix(firecrawl): forward firecrawl error ..." | Re-trigger Greptile}

@greptile

@cursor review